im: Deprecate gtk_im_multicontext_append_menuitems

Bug #701840.

diff --git a/gtk/gtkimmulticontext.c b/gtk/gtkimmulticontext.c
index 712d5ca8736d83396e7295ca70b4f49796efd579..4fc9cf15c159d25d898cf9626119cc77354fc041 100644 (file)
--- a/gtk/gtkimmulticontext.c
+++ b/gtk/gtkimmulticontext.c
@@ -592,6 +592,11 @@ pathnamecmp (const char *a,
  * Add menuitems for various available input methods to a menu;
  * the menuitems, when selected, will switch the input method
  * for the context and the global default input method.
+ *
+ * Deprecated: 3.10: It is better to use the system-wide input
+ *     method framework for changing input methods. Modern
+ *     desktop shells offer on-screen displays for this that
+ *     can triggered with a keyboard shortcut, e.g. Super-Space.
  **/
 void
 gtk_im_multicontext_append_menuitems (GtkIMMulticontext *context,

diff --git a/gtk/gtkimmulticontext.h b/gtk/gtkimmulticontext.h
index 6ab022e1e04f6d15fb9692c4172d69ff7033c803..77bc70c0d14bc1449b3ac2c6438eb850e4bf4506 100644 (file)
--- a/gtk/gtkimmulticontext.h
+++ b/gtk/gtkimmulticontext.h
@@ -63,7 +63,7 @@ GType         gtk_im_multicontext_get_type (void) G_GNUC_CONST;
 GDK_AVAILABLE_IN_ALL
 GtkIMContext *gtk_im_multicontext_new      (void);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_10
 void          gtk_im_multicontext_append_menuitems (GtkIMMulticontext *context,
                                                    GtkMenuShell      *menushell);
 GDK_AVAILABLE_IN_ALL